home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / SIMIIE.ZIP;1 / SIMIIE.DOC < prev    next >
Encoding:
Text File  |  1994-04-07  |  48.1 KB  |  1,016 lines
  1.  
  2.  
  3.                                     Page 1
  4.  
  5.  
  6.                      SimSystem IIe - Version 1.0 Shareware
  7.  
  8.                  Copyright (c) 1994 by American Research Inc.
  9.  
  10.                             Developed by Jim Sproul
  11.  
  12.                               All Rights Reserved
  13.  
  14.  
  15.  
  16.                             I N T R O D U C T I O N
  17.  
  18.  
  19.  
  20.     SimSystem IIe is amazing!  It will make your PC compatible computer
  21.  
  22.     system look, sound, and act just like an Apple IIe computer!
  23.  
  24.  
  25.  
  26.     With SimSystem IIe you will be able to run your favorite Apple II
  27.  
  28.     software.  SimSystem IIe supports all standard Apple graphics modes,
  29.  
  30.     so your favorite Apple games will work perfectly.  Even the sound is
  31.  
  32.     reproduced exactly!
  33.  
  34.  
  35.  
  36.     SimSystem IIe supports all of the standard keys on an Apple IIe
  37.  
  38.     keyboard, including the Open Apple and Solid Apple keys.  And,
  39.  
  40.     SimSystem IIe will let you use your PC joystick with Apple programs
  41.  
  42.     that require a joystick.
  43.  
  44.  
  45.  
  46.     SimSystem IIe simulates an Apple IIe compatible computer with FOUR
  47.  
  48.     DISK DRIVES!  Two are simulated 5 1/4 inch diskette drives, and two
  49.  
  50.     are ProDOS compatible hard disk drives.  You can swap disks anytime by
  51.  
  52.     pressing a function key and selecting another 'disk'.  You can even
  53.  
  54.     swap disks on the two simulated hard drives!  And, SimSystem IIe
  55.  
  56.     emulates the Apple Disk II floppy drive so well that you can even use
  57.  
  58.     some copy protected programs with SimSystem IIe!
  59.  
  60.  
  61.  
  62.     SimSystem IIe does MORE than a real Apple IIe!  Programmers will love
  63.  
  64.     the enhanced 65C02 monitor!  And, the built-in debugger is as powerful
  65.  
  66.     as an expensive in-circuit emulator!
  67.  
  68.  
  69.  
  70.     SimSystem IIe can simulate an Apple IIe with a color or monochrome
  71.  
  72.     monitor.  The VGA display mode is breathtaking - you'll swear you're
  73.  
  74.     looking at an Apple IIe display!  And, SimSystem IIe works with CGA
  75.  
  76.     and EGA display adaptors, too!
  77.  
  78.  
  79.  
  80.     Don't forget - SimSystem IIe is SHAREWARE!  Registered users get the
  81.  
  82.     latest updated version of SimSystem IIe, a nicely printed and bound
  83.  
  84.     manual (with pictures...), and the SimDisk utility (for creating
  85.  
  86.     'disks' for use with SimSystem IIe).
  87.  
  88.  
  89.  
  90.     This manual provides a brief overview of SimSystem IIe.  Registered
  91.  
  92.     users receive complete in-depth documentation.
  93.  
  94.  
  95.  
  96.                                     Page 2
  97.  
  98.  
  99.                         T A B L E  O F  C O N T E N T S
  100.  
  101.  
  102.  
  103.               Introduction..................................Page 1
  104.  
  105.  
  106.  
  107.               Legal Statement...............................Page 3
  108.  
  109.  
  110.  
  111.               Chapter 1 - Features..........................Page 5
  112.  
  113.  
  114.  
  115.               Chapter 2 - System Requirements And
  116.  
  117.                 Compatibility...............................Page 6
  118.  
  119.  
  120.  
  121.               Chapter 3 - Performance.......................Page 7
  122.  
  123.  
  124.  
  125.               Chapter 4 - Installation Guide................Page 8
  126.  
  127.  
  128.  
  129.               Chapter 5 - Getting Starting: SimSystem IIe
  130.  
  131.                 Configuration...............................Page 9
  132.  
  133.  
  134.  
  135.               Chapter 6 - Volume Files: The SimSystem IIe
  136.  
  137.                 Disk Drives.................................Page 13
  138.  
  139.  
  140.  
  141.               Chapter 7 - Booting The Emulator: The
  142.  
  143.                 Volume Selector.............................Page 14
  144.  
  145.  
  146.  
  147.               Chapter 8 - The Emulator Keyboard.............Page 16
  148.  
  149.  
  150.  
  151.               Chapter 9 - SimSystem IIe Function Keys.......Page 17
  152.  
  153.  
  154.  
  155.               Chapter 10 - The SimSystem IIe Debugger.......Page 19
  156.  
  157.  
  158.  
  159.               Chapter 11 - Volume File Formats..............Page 21
  160.  
  161.  
  162.  
  163.               Appendix - Registration.......................Page 23
  164.  
  165.  
  166.  
  167.                                          Page 3
  168.  
  169.  
  170.                                      Legal Statement
  171.  
  172.                                      _______________
  173.  
  174.  
  175.  
  176.     SimSystem IIe was developed by Jim Sproul for American Research Inc. 
  177.  
  178.     SimSystem IIe is copyright (c) 1994 by American Research Inc. 
  179.  
  180.     SimSystem IIe and SimSystem are trademarks of American Research Inc. 
  181.  
  182.     All rights reserved.
  183.  
  184.  
  185.  
  186.     COPYRIGHTS AND TRADEMARKS USED IN THIS DOCUMENT
  187.  
  188.  
  189.  
  190.     Apple, Apple IIe, Apple DOS, and Apple ProDOS are trademarks of Apple
  191.  
  192.     Computer Corporation.  AppleWorks is a trademark of Claris
  193.  
  194.     Corporation.  MS-DOS is a trademark of Microsoft Corporation.  IBM is
  195.  
  196.     a trademark of International Business Machines Inc.  
  197.  
  198.  
  199.  
  200.     SIMSYSTEM IIE IS SHAREWARE.
  201.  
  202.  
  203.  
  204.     License is hereby granted to the end user to use SimSystem IIe for a
  205.  
  206.     period of ten days for the purpose of evaluating the usefulness of the
  207.  
  208.     software.  After that time the software must be purchased by sending
  209.  
  210.     the registration fee, currently $50 US, to American Research Inc.  If
  211.  
  212.     the registration fee is not paid after ten days the end user must stop
  213.  
  214.     using the software, and must destroy any copies of the program in
  215.  
  216.     his/her possession.  Instructions for registering SimSystem IIe are
  217.  
  218.     provided at the end of this document.
  219.  
  220.  
  221.  
  222.     Bulletin Board System (BBS) operators may receive a free registration
  223.  
  224.     for SimSystem IIe by making SimSystem IIe available on their BBS
  225.  
  226.     system, and sending in the SimSystem IIe registration form along with
  227.  
  228.     instructions for accessing the BBS.  After verifying that SimSystem
  229.  
  230.     IIe is available, and that the conditions of distribution are being
  231.  
  232.     met, we will send the registered version of SimSystem IIe, a printed
  233.  
  234.     and bound manual, and the SimDisk utility.  The ten day evaluation
  235.  
  236.     period is waived for BBS operators who make SimSystem IIe available on
  237.  
  238.     their BBS system, and who comply with the terms of distribution given
  239.  
  240.     below.
  241.  
  242.  
  243.  
  244.     DISTRIBUTION
  245.  
  246.  
  247.  
  248.     SimSystem IIe may be distributed, either on magnetic media or via
  249.  
  250.     modem, for the purpose of exposing the product to other potential
  251.  
  252.     users, providing that all original files are included, intact and
  253.  
  254.     unmodified, and that no additional files are provided in association
  255.  
  256.     with the product.  SimSystem IIe may NOT be distributed on a bulletin
  257.  
  258.     board system (BBS) that illegally distributes copyrighted commercial
  259.  
  260.     software.
  261.  
  262.  
  263.  
  264.     COMMERCIAL SHAREWARE DISTRIBUTION
  265.  
  266.  
  267.  
  268.     SimSystem IIe may be distributed by commercial shareware distribution
  269.  
  270.     firms provided that the terms of distribution outlined above are
  271.  
  272.     complied with, and that the shareware nature of the product is CLEARLY
  273.  
  274.     stated on the product packaging and on the media (diskette, CD, etc.).
  275.  
  276.  
  277.  
  278.     SIMSYSTEM IIE IS AN ORIGINAL PRODUCT
  279.  
  280.  
  281.                                     Page 4
  282.  
  283.  
  284.  
  285.  
  286.     SimSystem IIe was written by Jim Sproul for American Research Inc. 
  287.  
  288.     The program was written in 80286 assembly language, except for the
  289.  
  290.     interpreted pseudo-ROM program, which was written in 65C02 assembly
  291.  
  292.     language.  SimSystem IIe does NOT contain any program code in any form
  293.  
  294.     (interpreted or executable) which is the copyrighted property of Apple
  295.  
  296.     Computer.  (This becomes apparent if the user examines the 65C02
  297.  
  298.     monitor program.)
  299.  
  300.  
  301.  
  302.     USE OF COMMERCIAL SOFTWARE WITH SIMSYSTEM IIE
  303.  
  304.  
  305.  
  306.     The end user MUST have a license from the software publisher to use
  307.  
  308.     any commercial software with SimSystem IIe.  This license is usually
  309.  
  310.     granted, with some limitations, when the user purchases the software. 
  311.  
  312.     Some software licenses may stipulate that the software may only be
  313.  
  314.     used on a computer system which is manufactured by, or under license
  315.  
  316.     from, Apple Computer.  Software products bearing such a license
  317.  
  318.     stipulation may NOT be used legally with SimSystem IIe.
  319.  
  320.  
  321.  
  322.     WARNING: The use of commercial software products with SimSystem IIe
  323.  
  324.     which are not obtained through legal means (i.e., purchased) is
  325.  
  326.     ILLEGAL!
  327.  
  328.  
  329.  
  330.     DISCLAIMER
  331.  
  332.  
  333.  
  334.     SimSystem IIe is provided solely for the amusement of the user. 
  335.  
  336.     American Research Inc. makes no guarantee regarding the usefulness of
  337.  
  338.     the product, and does not guarantee that the product will operate
  339.  
  340.     uninterrupted, or will be free of errors.  American Research Inc. will
  341.  
  342.     not be responsible for any damages resulting from the failure of the
  343.  
  344.     product to perform as expected.  The user is  urged to read this
  345.  
  346.     document in its entirety (especially the Compatibility Guide) before
  347.  
  348.     using SimSystem IIe.
  349.  
  350.  
  351.  
  352.                                     Page 5
  353.  
  354.  
  355.                              Chapter 1 - Features
  356.  
  357.                              ____________________
  358.  
  359.  
  360.  
  361.     SimSystem IIe is configured to emulate an Apple IIe with the following
  362.  
  363.     features:
  364.  
  365.  
  366.  
  367.          * 128K RAM (64K main / 64K auxiliary)
  368.  
  369.          * 65C02 microprocessor
  370.  
  371.          * Parallel printer adaptor in 'slot 1'
  372.  
  373.          * 80-column display adaptor in 'slot 3'
  374.  
  375.          * Dual floppy drive adaptor in 'slot 6'
  376.  
  377.          * Dual hard drive adaptor (removeable media) in 'slot 7'
  378.  
  379.  
  380.  
  381.     In addition, SimSystem IIe has the following features:
  382.  
  383.  
  384.  
  385.          * Supports CGA, EGA, and VGA display adaptors.
  386.  
  387.  
  388.  
  389.          * Emulates all standard Apple display modes, including 40 column
  390.  
  391.          text, 80 column text, low resolution graphics, high resolution
  392.  
  393.          graphics, and double high resolution graphics.
  394.  
  395.  
  396.  
  397.          * Emulates full Apple keyboard, including Open Apple and Solid
  398.  
  399.          Apple keys.
  400.  
  401.  
  402.  
  403.          * Emulates Apple joystick using standard PC game port.
  404.  
  405.  
  406.  
  407.          * Emulates Apple internal speaker sound.
  408.  
  409.  
  410.  
  411.          * Built-in enhanced 65C02 monitor.
  412.  
  413.  
  414.  
  415.          * Built-in 65C02 debugger supports breakpoints, single step,
  416.  
  417.          register display, and more.
  418.  
  419.  
  420.  
  421.          * Use files on your hard disk as 'disks' for four simulated disk
  422.  
  423.          drives.  Swap disks anytime by pressing a function key (even on
  424.  
  425.          the simulated hard drives).
  426.  
  427.  
  428.  
  429.          * Special set-up screen lets you choose your PC video mode,
  430.  
  431.          select printer and game port, turn on/off sound, enable/disable
  432.  
  433.          debugger, etc.  Save your configuration and SimSystem IIe will
  434.  
  435.          always start up the way you want it to.
  436.  
  437.  
  438.  
  439.                                        Page 6
  440.  
  441.  
  442.                  Chapter 2 - System Requirements And Compatibility
  443.  
  444.                  _________________________________________________
  445.  
  446.  
  447.  
  448.     SimSystem IIe requires a 100% IBM compatible computer system with an
  449.  
  450.     80286 (or downward compatible) microprocessor.  A graphics display
  451.  
  452.     adaptor (CGA, EGA, or VGA) is required.  A parallel printer adaptor
  453.  
  454.     and game port are also optional.  Although not required, a hard disk
  455.  
  456.     is highly recommended for maximum performance.
  457.  
  458.  
  459.  
  460.     SimSystem IIe will NOT work on systems with an 8086, 8088, or V20
  461.  
  462.     microprocessor.  
  463.  
  464.  
  465.  
  466.     SimSystem IIe is NOT compatible with Microsoft Windows, and may not be
  467.  
  468.     run as a DOS task under Windows.  SimSystem IIe changes the keyboard
  469.  
  470.     interrupt vector, and deals directly with system hardware for maximum
  471.  
  472.     performance.
  473.  
  474.  
  475.  
  476.     SimSystem IIe is known to be incompatible with many IBM portable
  477.  
  478.     computers, and Viglen computer systems (manufactured in the U.K.).  If
  479.  
  480.     you find SimSystem IIe does not function on your computer system
  481.  
  482.     please write to American Research Inc., at the address provided, and
  483.  
  484.     describe your computer system and the symptoms of the problem.  If we
  485.  
  486.     find the problem is due to a bug in SimSystem IIe we will send you a
  487.  
  488.     registered copy of SimSystem IIe at no charge!
  489.  
  490.  
  491.  
  492.                                     Page 7
  493.  
  494.  
  495.                             Chapter 3 - Performance
  496.  
  497.                             _______________________
  498.  
  499.  
  500.  
  501.     The performance of SimSystem IIe, as compared to a real Apple IIe,
  502.  
  503.     will vary considerably.  This depends on the type and speed of your
  504.  
  505.     microprocessor, the number of wait states imposed by your system
  506.  
  507.     memory, the speed of your display adaptor, etc.
  508.  
  509.  
  510.  
  511.     SimSystem IIe running on an 80286 system operating at 12 MHz will be
  512.  
  513.     painfully slow, and probably not useful for anything except the most
  514.  
  515.     mundane tasks.  If you have a system like this then you may not be
  516.  
  517.     bothered by the lackluster performance, as you are probably already
  518.  
  519.     used to a lot of waiting.  You might consider donating your system to
  520.  
  521.     your local Salvation Army Thrift Store or elementary school.
  522.  
  523.  
  524.  
  525.     SimSystem IIe running on an 80386 system operating at 20 MHz will show
  526.  
  527.     adequate performance for most text based tasks, such as AppleWorks. 
  528.  
  529.     However, video games will probably not offer enough of a challenge for
  530.  
  531.     anyone over the age of six.
  532.  
  533.  
  534.  
  535.     SimSystem IIe running on an 80486SX system operating at 25 MHz will
  536.  
  537.     perform well beyond the speed of an Apple IIe for computational uses,
  538.  
  539.     but will perform at about the same speed for graphics operations.
  540.  
  541.  
  542.  
  543.     You can improve the performance of SimSystem IIe by operating the
  544.  
  545.     program in CGA mode (even if you have an EGA or VGA display adaptor),
  546.  
  547.     and by using the program with the debugger option turned off.
  548.  
  549.  
  550.  
  551.                                     Page 8
  552.  
  553.  
  554.                         Chapter 4 - Installation Guide
  555.  
  556.                         ______________________________
  557.  
  558.  
  559.  
  560.     Since you are reading this document you have already discovered that
  561.  
  562.     the first step in installing SimSystem IIe is to extract the
  563.  
  564.     individual files from the archive (SIMIIE.ZIP).
  565.  
  566.  
  567.  
  568.     SimSystem IIe comes with the following files:
  569.  
  570.  
  571.  
  572.          SIMIIE.EXE - the SimSystem IIe program
  573.  
  574.          MON.ROM - the SimSystem IIe 65C02 monitor program
  575.  
  576.          SLOT.ROM - the SimSystem IIe 65C02 expansion slot programs
  577.  
  578.          DIAG.ROM - the SimSystem IIe 65C02 resident programs
  579.  
  580.          EXP.ROM - the SimSystem IIe expansion programs
  581.  
  582.          DEMO.IIE - a simple game developed with SimSystem IIe
  583.  
  584.          FLOBYN.IIE - a public domain game for the Apple IIe
  585.  
  586.          SIMIIE.DOC - this file
  587.  
  588.  
  589.  
  590.     We strongly recommend that you copy all of these files into a single
  591.  
  592.     subdirectory on your PC hard drive.  We usually name this subdirectory
  593.  
  594.     SIMIIE.  All of the files with the 'ROM' extension are 65C02 programs
  595.  
  596.     that SimSystem IIe uses for its simulated ROM memory.  SimSystem IIe
  597.  
  598.     looks for these files in the current directory on startup.
  599.  
  600.  
  601.  
  602.                                     Page 9
  603.  
  604.  
  605.            Chapter 5 - Getting Started: SimSystem IIe Configuration
  606.  
  607.            ________________________________________________________
  608.  
  609.  
  610.  
  611.     You can run SimSystem IIe by typing the following command at the
  612.  
  613.     MS-DOS prompt:
  614.  
  615.          SIMIIE<Enter>
  616.  
  617.     Of course, the phrase <Enter> means to press the Enter key.
  618.  
  619.  
  620.  
  621.     If SimSystem IIe does not find a valid SIMIIE.CFG file in the startup
  622.  
  623.     directory then you will be presented with the SimSystem IIe
  624.  
  625.     configuration screen.  This screen allows you to select options for
  626.  
  627.     SimSystem IIe, which you can save for future use.  Even after saving
  628.  
  629.     your preferred configuration in the SIMIIE.CFG file you can still
  630.  
  631.     change the configuration later by entering:
  632.  
  633.          SIMIIE /S<Enter>
  634.  
  635.     This command will cause SimSystem IIe to load the SIMIIE.CFG
  636.  
  637.     configuration and display the configuration screen so that you may
  638.  
  639.     make changes.  Should you ever wish to restore the factory default
  640.  
  641.     configuration you can simply erase the SIMIIE.CFG file from your
  642.  
  643.     startup directory, and SimSystem IIe will start just like the first
  644.  
  645.     time you used it.
  646.  
  647.  
  648.  
  649.     Each of the configuration options is described below.
  650.  
  651.  
  652.  
  653.     1...Video Mode
  654.  
  655.          Pressing the '1' key will cycle through each of the available
  656.  
  657.          video mode options.  These options refer to the PC video mode
  658.  
  659.          which SimSystem IIe will use when simulating the Apple IIe
  660.  
  661.          display.  All Apple IIe display modes are supported by SimSystem
  662.  
  663.          IIe regardless of which PC display mode you choose.
  664.  
  665.  
  666.  
  667.          CGA display mode uses a graphics screen which is 640 dots wide,
  668.  
  669.          and 200 dots high, and is black-and-white.  When this option is
  670.  
  671.          selected SimSystem IIe will simulate an Apple IIe with a
  672.  
  673.          monochrome monitor.  This is the only option that will work for
  674.  
  675.          PC computer systems with a CGA display adaptor.  However, since
  676.  
  677.          screen graphics operate much faster in this mode, owners of EGA
  678.  
  679.          or VGA equipped computers might choose to use this mode for some
  680.  
  681.          graphics intensive programs.
  682.  
  683.  
  684.  
  685.          EGA display mode uses a graphics screen which is 640 dots wide,
  686.  
  687.          and 200 dots high, and uses 16 colors.  In this mode SimSystem
  688.  
  689.          IIe will simulate an Apple IIe with a color display.  This mode
  690.  
  691.          can be used with EGA and VGA equipped systems.  This mode is also
  692.  
  693.          compatible with computers having an EGA display adaptor and a
  694.  
  695.          non-enhanced (CGA) monitor.
  696.  
  697.  
  698.  
  699.          VGA equipped machines pose a special problem for SimSystem IIe. 
  700.  
  701.          The quality of the display produced by the VGA display adaptor is
  702.  
  703.          much higher than that of a real Apple IIe, making it difficult to
  704.  
  705.          produce a realistic looking display.  The Apple IIe display only
  706.  
  707.          uses half of the available scan lines, leaving a thin black
  708.  
  709.          stripe between rows of dots.  In low resolution display modes the
  710.  
  711.          VGA display adaptor will actually display each row of dots twice
  712.  
  713.          in order to fill in the black space.  While this process, called
  714.  
  715.  
  716.                                       Page 10
  717.  
  718.  
  719.          double scanning, might produce a better looking PC display
  720.  
  721.          screen, it makes a simulated Apple IIe display look bright and
  722.  
  723.          chunky.  SimSystem IIe compensates for this by operating the VGA
  724.  
  725.          display adaptor in the 640 by 480 dot display mode, and
  726.  
  727.          intentionally skipping alternating rows of dots.  This adds the
  728.  
  729.          original black space between rows of dots, producing a strikingly
  730.  
  731.          realistic display.
  732.  
  733.  
  734.  
  735.     2...Printer Port
  736.  
  737.  
  738.  
  739.          SimSystem IIe simulates an Apple IIe with a parallel printer
  740.  
  741.          adaptor card installed in 'slot 1'.  This option allows you to
  742.  
  743.          choose which printer port on your PC to use when an Apple II
  744.  
  745.          program is sending data to your printer.  Pressing the '2' key
  746.  
  747.          will cycle through the available options.  If you don't have a
  748.  
  749.          printer attached to your PC, or if you choose not to use a
  750.  
  751.          printer with SimSystem IIe, then you can select the 'NONE'
  752.  
  753.          option.
  754.  
  755.  
  756.  
  757.     3...Modem Port
  758.  
  759.  
  760.  
  761.          This option is provided in the event a future version of
  762.  
  763.          SimSystem IIe is written that supports a modem card in 'slot 2'. 
  764.  
  765.          The current version of SimSystem IIe does not support this.
  766.  
  767.  
  768.  
  769.     4...Game
  770.  
  771.  
  772.  
  773.          Press the '4' key to toggle this option between 'ON' and 'OFF'. 
  774.  
  775.          When this option is set 'ON' SimSystem IIe will support the use
  776.  
  777.          of a PC joystick with Apple II programs that require a joystick
  778.  
  779.          or paddles.  If your PC system is not equipped with a game port
  780.  
  781.          or joystick, or you don't wish to use a joystick with any Apple
  782.  
  783.          programs, then set this option to 'OFF'.
  784.  
  785.  
  786.  
  787.     5...Mouse
  788.  
  789.  
  790.  
  791.          This option is provided in the event a future version of
  792.  
  793.          SimSystem IIe is written that supports a mouse card in 'slot 4'. 
  794.  
  795.          The current version of SimSystem IIe does not support this.
  796.  
  797.  
  798.  
  799.     6...Sound
  800.  
  801.  
  802.  
  803.          Press the '6' key to toggle this option between 'ON' and 'OFF'. 
  804.  
  805.          When this option is set 'ON' SimSystem IIe will simulate Apple
  806.  
  807.          IIe sound through the internal speaker on your PC.  If your PC is
  808.  
  809.          an older (and slower) machine than you might find the simulated
  810.  
  811.          audio annoying, and you may wish to set this option to 'OFF'.
  812.  
  813.  
  814.  
  815.     A through G...Emulator System
  816.  
  817.  
  818.  
  819.          These options are provided to remind you which simulated
  820.  
  821.          expansion cards are installed in each SimSystem IIe 'slot'.  A
  822.  
  823.          future version of SimSystem IIe might allow you to select
  824.  
  825.          different simulated cards for each slot.
  826.  
  827.  
  828.  
  829.  
  830.                                     Page 11
  831.  
  832.  
  833.     H...Debugger
  834.  
  835.  
  836.  
  837.          Press the 'H' key to alternate between ON and OFF.  The SimSystem
  838.  
  839.          IIe debugger will allow programmers direct access to the
  840.  
  841.          simulated 65C02 microprocessor.  Using the debugger you can stop
  842.  
  843.          the processor, display the contents of the 65C02 registers, step
  844.  
  845.          through the program one instruction at a time, and set hardware
  846.  
  847.          breakpoints, all without any adverse affect on the program being
  848.  
  849.          run.  SimSystem IIe will operate more slowly while the debugger
  850.  
  851.          is enabled, so you should switch it off unless you need to use
  852.  
  853.          it.  Use of the SimSystem IIe debugger is described in detail in
  854.  
  855.          chapter 10.
  856.  
  857.  
  858.  
  859.     I...Page Flip
  860.  
  861.  
  862.  
  863.          The Apple IIe provides two video display buffers for most display
  864.  
  865.          modes, and SimSystem IIe supports this.  Some programs will
  866.  
  867.          display the image from one of the two display buffers while
  868.  
  869.          creating another image in the alternate buffer.  When the image
  870.  
  871.          is completed the program will switch the display to the alternate
  872.  
  873.          display buffer using a technique called 'page flipping'. 
  874.  
  875.          SimSystem IIe tries to be intelligent about page flipping, and
  876.  
  877.          only redraws the portion of the display screen which has actually
  878.  
  879.          changed.  While this works fine for most graphics programs, some
  880.  
  881.          programs will page flip between two completely different display
  882.  
  883.          screens, causing SimSystem IIe to do a lot of screen drawing.  If
  884.  
  885.          you find a graphics program is operating more slowly with
  886.  
  887.          SimSystem IIe, and you suspect that page flipping is the problem,
  888.  
  889.          you might try running the program with the page flipping option
  890.  
  891.          turned OFF.  This will force SimSystem IIe to display only one
  892.  
  893.          display buffer.  You can select which of the two buffers is
  894.  
  895.          displayed while the program is running by pressing the F6 key. 
  896.  
  897.          (Use of the F6 key is described in chapter 9.)
  898.  
  899.  
  900.  
  901.     J...Flash Text
  902.  
  903.  
  904.  
  905.          Both the Apple IIe and the PC support a form of flashing text
  906.  
  907.          when the display is operating in text mode.  On the Apple IIe the
  908.  
  909.          text will alternate between normal (white on black) and inverse
  910.  
  911.          (black on white) at regular intervals.  On the PC the text will
  912.  
  913.          alternate between on and off.  SimSystem IIe supports the Apple
  914.  
  915.          IIe style flashing text by periodically redrawing the flashing
  916.  
  917.          characters in reverse.  While this produces a very realistic
  918.  
  919.          simulated Apple display, it can cause a noticeable decrease in
  920.  
  921.          performance on slower machines.  Turn this option OFF if you
  922.  
  923.          suspect that flashing text is a problem.
  924.  
  925.  
  926.  
  927.     R...Run SimSystem IIe
  928.  
  929.  
  930.  
  931.          Select this option to start the SimSystem IIe emulator.
  932.  
  933.  
  934.  
  935.     S...Save Configuration
  936.  
  937.  
  938.  
  939.          Select this option to save the current configuration in the
  940.  
  941.          SIMIIE.CFG file.  If the file already exists it will be replaced.
  942.  
  943.  
  944.                                       Page 12
  945.  
  946.  
  947.          Once this file has been created SimSystem IIe will not
  948.  
  949.          automatically enter the configuration mode on startup unless the
  950.  
  951.          /S switch is provided on the command line.
  952.  
  953.  
  954.  
  955.     Esc...Return to DOS
  956.  
  957.  
  958.  
  959.          If, after making changes to the configuration screen, you do not
  960.  
  961.          wish to start the SimSystem IIe emulator, you may return to the
  962.  
  963.          MS-DOS prompt by pressing the Esc key.
  964.  
  965.  
  966.  
  967.                                       Page 13
  968.  
  969.  
  970.               Chapter 6 - Volume Files: The SimSystem IIe Disk Drives
  971.  
  972.               _______________________________________________________
  973.  
  974.  
  975.  
  976.     SimSystem IIe emulates an Apple IIe with four disk drives, two floppy
  977.  
  978.     drives and two hard drives.  These simulated disk drives exist only in
  979.  
  980.     software, which is to say that the disk drives don't physically exist.
  981.  
  982.     An Apple II program will find all of the appropriate hardware
  983.  
  984.     registers for these disk drives only because SimSystem IIe simulates
  985.  
  986.     these registers.  In fact, SimSystem IIe simulates these disk drives
  987.  
  988.     so well that many copy protected programs will work.
  989.  
  990.  
  991.  
  992.     These simulated disk drives need simulated disks in order to work. 
  993.  
  994.     These disks are provided in the form of files on your PC hard drive. 
  995.  
  996.     In most cases, these files contain a complete copy of the contents of
  997.  
  998.     a real Apple disk.  We call these 'volume files'.
  999.  
  1000.  
  1001.  
  1002.     Volume files for use with the simulated floppy drives will have the
  1003.  
  1004.     MS-DOS extension *.IIE, while files for use with the simulated hard
  1005.  
  1006.     drives will have the MS-DOS extension *.HDV.  SimSystem IIe provides a
  1007.  
  1008.     special file selector that allows you to swap disks in any of the
  1009.  
  1010.     simulated disk drives (including the simulated hard drives) by simply
  1011.  
  1012.     selecting another volume file.
  1013.  
  1014.  
  1015.  
  1016.     A floppy volume file (*.IIE) will always contain 143360 bytes of data,
  1017.  
  1018.     while a hard drive volume file (*.HDV) may vary between 800K and 16M. 
  1019.  
  1020.     The Apple ProDOS 3 1/2 inch diskettes can be simulated by using 800K
  1021.  
  1022.     hard drive volumes.  The simulated hard drive conforms to Apple ProDOS
  1023.  
  1024.     standards, and can only be used with ProDOS.
  1025.  
  1026.  
  1027.  
  1028.     Floppy volume files (*.IIE) can contain data in two different formats;
  1029.  
  1030.     binary and GCR.  Binary format files are always 143390 bytes in
  1031.  
  1032.     length, while GCR format files will vary in length (usually greater
  1033.  
  1034.     than 200K).  Binary format files are used for most applications where
  1035.  
  1036.     program code or data is stored in standard Apple format, and no copy
  1037.  
  1038.     protection is used.  GCR format files contain a copy of the disk data
  1039.  
  1040.     in its purest GCR encoded format, the same way it is stored on a real
  1041.  
  1042.     Apple II diskette.  SimSystem IIe does not interpret or translate GCR
  1043.  
  1044.     data in any way, whichs makes this format suitable for many copy
  1045.  
  1046.     protection methods used on Apple II products.
  1047.  
  1048.  
  1049.  
  1050.     You will need the SimDisk program in order to create volume files for
  1051.  
  1052.     SimSystem IIe.  This program allows you to download Apple compatible
  1053.  
  1054.     programs via modem, or directly from an Apple II computer system.  You
  1055.  
  1056.     can also use a Deluxe Option Board, from Central Point Software, to
  1057.  
  1058.     directly read Apple diskettes in your PC floppy drive.  SimDisk is
  1059.  
  1060.     provided to registered users of SimSystem IIe.
  1061.  
  1062.  
  1063.  
  1064.                                     Page 14
  1065.  
  1066.  
  1067.              Chapter 7 - Booting The Emulator: The Volume Selector
  1068.  
  1069.              _____________________________________________________
  1070.  
  1071.  
  1072.  
  1073.     You can start the SimSystem IIe emulator by selecting the 'R' option
  1074.  
  1075.     from the configuration screen.  If you have saved your configuration
  1076.  
  1077.     in the SIMIIE.CFG file, then the emulator will start automatically
  1078.  
  1079.     when you run the SIMIIE program.
  1080.  
  1081.  
  1082.  
  1083.     Just like a real Apple IIe, the first thing SimSystem IIe will try to
  1084.  
  1085.     do is load an operating system from one of the simulated disk drives. 
  1086.  
  1087.     This process is called 'bootstrap', or booting.
  1088.  
  1089.  
  1090.  
  1091.     SimSystem IIe provides the Volume Selector to allow you to choose a
  1092.  
  1093.     volume file for any of the simulated disk drives.  The Volume Selector
  1094.  
  1095.     is displayed at startup so that you can select a volume file to boot. 
  1096.  
  1097.     You can also call up the Volume Selector at any time while using
  1098.  
  1099.     SimSystem IIe by pressing the F7 function key.
  1100.  
  1101.  
  1102.  
  1103.     If your keyboard fails to work at this point it is probably because
  1104.  
  1105.     your PC keyboard system is not 100% IBM compatible, as required for
  1106.  
  1107.     SimSystem IIe.  If this is the case then SimSystem IIe will NOT work
  1108.  
  1109.     with your computer.  Please write to American Research at the address
  1110.  
  1111.     provided at the end of this manual, and let us know what kind of
  1112.  
  1113.     computer system you are using.
  1114.  
  1115.  
  1116.  
  1117.     The Volume Selector is displayed using the simulated Apple 80-column
  1118.  
  1119.     display characters.  The Volume Selector box is outlined in inverse
  1120.  
  1121.     box characters, and contains the title 'VOLUME' at the top.  Inside
  1122.  
  1123.     the box are listed up to eight files or subdirectories on your PC hard
  1124.  
  1125.     drive.  If the file listed is a subdirectory then the letter 'D' will
  1126.  
  1127.     appear in the border to the left of the filename.
  1128.  
  1129.  
  1130.  
  1131.     The selected disk drive is listed in the bottom border of the box
  1132.  
  1133.     after the word 'TAB' in the format 'SnDn'.  The number following the
  1134.  
  1135.     'S' indicates the 'slot', where slot 6 is the two simulated floppy
  1136.  
  1137.     drives, and slot 7 is the two simulated hard disk drives.  The number
  1138.  
  1139.     following the 'D' indicates which of the two simulated disk drives in
  1140.  
  1141.     each slot is selected, either 1 or 2.  By pressing the TAB key you can
  1142.  
  1143.     alternate between S6D1, S6D2, S7D1, and S7D2.  Note that when either
  1144.  
  1145.     of the two simulated floppy drives (slot 6) are selected then only
  1146.  
  1147.     files with the extension *.IIE will be displayed.  Similarly, when
  1148.  
  1149.     either of the two simulated hard drives (slot 7) are selected then
  1150.  
  1151.     only files with the extension *.HDV will be displayed.  All
  1152.  
  1153.     subdirectories will be displayed regardless of which simulated disk
  1154.  
  1155.     drive is selected.
  1156.  
  1157.  
  1158.  
  1159.     The selected file or subdirectory is displayed by highlighting its
  1160.  
  1161.     name in inverse characters (black on white).  You can change the
  1162.  
  1163.     selected file or subdirectory by using the UP and DOWN arrow keys
  1164.  
  1165.     (also called cursor keys) on your PC keyboard.  The list will scroll
  1166.  
  1167.     when the highlight bar reaches the bottom or top of the window, if
  1168.  
  1169.     more selections exist.  You can choose a file or subdirectory by
  1170.  
  1171.     moving the highlight bar over the name and pressing the Enter key.  If
  1172.  
  1173.     the selection is a subdirectory then the contents of that directory
  1174.  
  1175.     will be displayed in the window.  You can move to the previous
  1176.  
  1177.  
  1178.                                     Page 15
  1179.  
  1180.  
  1181.     subdirectory by selecting the '..' option from the list.  If the
  1182.  
  1183.     selection is a volume file then that file will be 'installed' in the
  1184.  
  1185.     selected simulated disk drive, and the Volume Selector will disappear.
  1186.  
  1187.  
  1188.  
  1189.     The current MS-DOS path is displayed at the bottom of the screen.
  1190.  
  1191.  
  1192.  
  1193.     You can exit from the Volume Selector without choosing a file by
  1194.  
  1195.     pressing the Esc key.  None of the selected volume files will be
  1196.  
  1197.     changed.  Leaving the Volume Selector displayed at boot time by
  1198.  
  1199.     pressing the Esc key is equivalent to starting an Apple IIe without
  1200.  
  1201.     any disks in the disk drives.  Like an Apple IIe, SimSystem IIe will
  1202.  
  1203.     run continuously trying to read a non-existent disk.  However, just
  1204.  
  1205.     like an Apple IIe, you can press RESET (function key F5) to proceed
  1206.  
  1207.     directly to the built-in BASIC interpreter.  Of course, no operating
  1208.  
  1209.     system is loaded so you won't be able to load or save any programs. 
  1210.  
  1211.     However, you can still play with BASIC, or the built-in monitor
  1212.  
  1213.     program.
  1214.  
  1215.  
  1216.  
  1217.     Once you have selected a volume file SimSystem IIe will begin loading
  1218.  
  1219.     the operating system from the volume.  After that, things works pretty
  1220.  
  1221.     much like a real Apple IIe!
  1222.  
  1223.  
  1224.  
  1225.                                     Page 16
  1226.  
  1227.  
  1228.                        Chapter 8 - The Emulator Keyboard
  1229.  
  1230.                        _________________________________
  1231.  
  1232.  
  1233.  
  1234.     Most of the keys on your PC keyboard work with the emulator.  All of
  1235.  
  1236.     the alphanumeric keys are the same, including Esc, Shift, Ctrl, Tab,
  1237.  
  1238.     Caps Lock, Backspace, and the arrow (cursor) keys.
  1239.  
  1240.  
  1241.  
  1242.     Functions keys F1 through F10 are used for special SimSystem IIe
  1243.  
  1244.     commands, and are not used by any Apple II programs.  The numeric
  1245.  
  1246.     keypad keys are equivalent to the numeric keys on the main keyboard.
  1247.  
  1248.  
  1249.  
  1250.     The Alt key to the left of the space bar is used for the Open Apple
  1251.  
  1252.     key.  The Alt key to the right of the space bar is used for the Solid
  1253.  
  1254.     Apple Key.  Note that the screen characters that represent these keys
  1255.  
  1256.     are replaced with Open Diamond and Solid Diamond (to avoid copyright
  1257.  
  1258.     problems with Apple Computer).
  1259.  
  1260.  
  1261.  
  1262.     None of the following keys perform any function with SimSystem IIe.
  1263.  
  1264.  
  1265.  
  1266.          Print Screen   Scroll Lock    Pause
  1267.  
  1268.          Insert         Home           Page Up
  1269.  
  1270.          Delete         End            Page Down
  1271.  
  1272.          Num Lock
  1273.  
  1274.  
  1275.  
  1276.     Some Apple operating systems, like Apple DOS, do not support all of
  1277.  
  1278.     the keys on an enhanced Apple IIe.  For example, Apple DOS does not
  1279.  
  1280.     recognize lower case characters.  However, like an Apple IIe,
  1281.  
  1282.     SimSystem IIe starts up in Caps Lock mode.  In addition, Apple DOS and
  1283.  
  1284.     AppleSoft BASIC do not recognize the Backspace key, and use instead
  1285.  
  1286.     the left arrow key.  In other words, use the keyboard just as you
  1287.  
  1288.     would on a real Apple IIe.
  1289.  
  1290.  
  1291.  
  1292.                                     Page 17
  1293.  
  1294.  
  1295.                     Chapter 9 - SimSystem IIe Function Keys
  1296.  
  1297.                     _______________________________________
  1298.  
  1299.  
  1300.  
  1301.     Some of the things you would do with a real Apple IIe are not directly
  1302.  
  1303.     possible with an emulator program.  SimSystem IIe uses function keys
  1304.  
  1305.     F1 through F10 to perform these special tasks.  The bar at the bottom
  1306.  
  1307.     of the screen is used to remind you of the purpose of these function
  1308.  
  1309.     keys.  Please note that this reminder bar is temporarily replaced by
  1310.  
  1311.     the MS-DOS path when using the Volume Selector, and by the debugger
  1312.  
  1313.     display (when enabled).  Each of the function keys is described below.
  1314.  
  1315.  
  1316.  
  1317.     F1 SHOW (Debugger)
  1318.  
  1319.  
  1320.  
  1321.          This key is used only when the SimSystem IIe debugger is enabled.
  1322.  
  1323.          This key allows you to alternate between the debugger display and
  1324.  
  1325.          the reminder bar.  The debugger display is described in the
  1326.  
  1327.          chapter 10 of this manual.
  1328.  
  1329.  
  1330.  
  1331.     F2 SNGL (Debugger)
  1332.  
  1333.  
  1334.  
  1335.          This key is used only when the SimSystem IIe debugger is enabled.
  1336.  
  1337.          This key allows you to alternate between RUN and STEP mode.  In
  1338.  
  1339.          RUN mode the simulated 65C02 processor will run continuously.  In
  1340.  
  1341.          STEP mode the simulated 65C02 processor can be stepped one
  1342.  
  1343.          instruction at a time using function key F4.
  1344.  
  1345.  
  1346.  
  1347.     F3 BRK (Debugger)
  1348.  
  1349.  
  1350.  
  1351.          This key is used only when the SimSystem IIe debugger is enabled.
  1352.  
  1353.          This key allows you to set a breakpoint address.  When the 65C02
  1354.  
  1355.          processor reaches the breakpoint address it will automatically
  1356.  
  1357.          switch into the STEP mode (see function key F2 and F4
  1358.  
  1359.          descriptions).
  1360.  
  1361.  
  1362.  
  1363.     F4 STEP (Debugger)
  1364.  
  1365.  
  1366.  
  1367.          This key is used only when the SimSystem IIe debugger is enabled.
  1368.  
  1369.          This key allows you to step the 65C02 processor one instruction
  1370.  
  1371.          at a time.  This key is only effective when the 65C02 processor
  1372.  
  1373.          is in STEP mode (see function key F2 description).
  1374.  
  1375.  
  1376.  
  1377.     F5 RST
  1378.  
  1379.  
  1380.  
  1381.          This key is equivalent to the RESET key on a real Apple IIe. 
  1382.  
  1383.          Pressing this key will cause the simulated 65C02 processor to be
  1384.  
  1385.          reset.  Some Apple II programs will alter the 65C02 reset
  1386.  
  1387.          address, which prevents the program from being stopped.  These
  1388.  
  1389.          programs will behave similarly with SimSystem IIe.  See function
  1390.  
  1391.          key F9 description below.
  1392.  
  1393.  
  1394.  
  1395.     F6 FLIP
  1396.  
  1397.  
  1398.  
  1399.          This key is used when the Page Flip option (on the configuration
  1400.  
  1401.          screen) is turned OFF.  Use this key with graphics mode programs
  1402.  
  1403.          to select which of the two display buffers will be shown on the
  1404.  
  1405.  
  1406.                                       Page 18
  1407.  
  1408.  
  1409.          screen.  Pressing this key will cause SimSystem IIe to switch
  1410.  
  1411.          between the two display buffers.  This feature is useful to
  1412.  
  1413.          programmers who want to watch screen data being created in a
  1414.  
  1415.          display buffer that would normally be hidden from view.
  1416.  
  1417.  
  1418.  
  1419.     F7 DISK
  1420.  
  1421.  
  1422.  
  1423.          Use this key to access the Volume Selector.  Use of the Volume
  1424.  
  1425.          Selector is described in chapter 7 of this manual.  The Volume
  1426.  
  1427.          Selector is sometimes useful as a PAUSE function in some games,
  1428.  
  1429.          since the emulator stops while the Volume Selector is displayed.
  1430.  
  1431.  
  1432.  
  1433.     F8 JOY
  1434.  
  1435.  
  1436.  
  1437.          This key is only useful if the Game Port option is enabled (on
  1438.  
  1439.          the configuration screen).  As you probably already know, not all
  1440.  
  1441.          PC joysticks are the same.  In addition, not all PC game port
  1442.  
  1443.          adaptors are the same.  Most PC games that use a joystick provide
  1444.  
  1445.          an option for 'calibrating' the stick to work properly with the
  1446.  
  1447.          game.  SimSystem IIe provides function key F8 for this purpose. 
  1448.  
  1449.          Position your joystick in the center position and press F8.  A
  1450.  
  1451.          reminder box will pop up to inform you when the calibration is
  1452.  
  1453.          complete.  THIS PROCESS MUST BE PERFORMED EVERY TIME YOU RUN
  1454.  
  1455.          SIMSYSTEM IIE, AND BEFORE USING THE JOYSTICK!  If your joystick
  1456.  
  1457.          features calibration adjustments you should set them in the
  1458.  
  1459.          center position before pressing F8.  The SimSystem IIe joystick
  1460.  
  1461.          emulation should work with virtually all Apple II games that use
  1462.  
  1463.          a joystick.
  1464.  
  1465.  
  1466.  
  1467.     F9 PWR
  1468.  
  1469.  
  1470.  
  1471.          Pressing this key is essentially the same as switching off an
  1472.  
  1473.          Apple IIe for a moment, then switching it back on.  Use the
  1474.  
  1475.          Volume Selector to select a new disk to boot before pressing F9.
  1476.  
  1477.  
  1478.  
  1479.     F10 BYE
  1480.  
  1481.  
  1482.  
  1483.          Use this key to return to the MS-DOS prompt.  No warnings are
  1484.  
  1485.          given, so press this key only if you want to leave SimSystem IIe.
  1486.  
  1487.  
  1488.  
  1489.                                       Page 19
  1490.  
  1491.  
  1492.                       Chapter 10 - The SimSystem IIe Debugger
  1493.  
  1494.                       _______________________________________
  1495.  
  1496.  
  1497.  
  1498.     The SimSystem IIe debugger is an advanced feature intended for
  1499.  
  1500.     programmers, and other technically inclined users.  Most users will
  1501.  
  1502.     choose to operate SimSystem IIe with the debugger option (on the
  1503.  
  1504.     configuration screen) turned OFF, since it significantly reduces the
  1505.  
  1506.     speed at which SimSystem IIe operates.
  1507.  
  1508.  
  1509.  
  1510.     A traditional debugger is a program that resides in memory with the
  1511.  
  1512.     program being tested.  The program under test must be reasonably well
  1513.  
  1514.     behaved in that it may not trash memory required by the debugger, or
  1515.  
  1516.     interact with system hardware in a manner the debugger doesn't expect,
  1517.  
  1518.     or both programs will crash.  A debugger is also a useful tool for
  1519.  
  1520.     examining how another program works.  Many copy protected programs, or
  1521.  
  1522.     programs which use proprietary software techniques or algorithms, are
  1523.  
  1524.     specifically designed so that a traditional debugger will not work
  1525.  
  1526.     with them.
  1527.  
  1528.  
  1529.  
  1530.     The SimSystem IIe debugger is different.  It works more like a piece
  1531.  
  1532.     of hardware attached to the microprocessor, or an in-circuit emulator
  1533.  
  1534.     device.  The SimSystem IIe debugger is not a program that coexists in
  1535.  
  1536.     65C02 memory, but is an enhancement to the 65C02 microprocessor
  1537.  
  1538.     emulator program.  In fact, the SimSystem IIe debugger was used
  1539.  
  1540.     extensively in testing SimSystem IIe.  Using the SimSystem IIe
  1541.  
  1542.     debugger, you can view each instruction the 65C02 executes BEFORE it
  1543.  
  1544.     actually executes them.  You can stop the processor at any time, view
  1545.  
  1546.     its register contents, single step through the instructions, and set
  1547.  
  1548.     hardware breakpoints at any address.
  1549.  
  1550.  
  1551.  
  1552.     Before you can use the SimSystem IIe debugger it must be enabled on
  1553.  
  1554.     the configuration screen.
  1555.  
  1556.  
  1557.  
  1558.     When you execute SimSystem IIe with the debugger enabled you will be
  1559.  
  1560.     presented with a box asking you to enter a breakpoint address in
  1561.  
  1562.     hexadecimal.  When the 6502 program executes an instruction at the
  1563.  
  1564.     specified breakpoint address SimSystem IIe will automatically switch
  1565.  
  1566.     into STEP mode (stopping the processor), and the debugger display will
  1567.  
  1568.     automatically be turned on.  SimSystem IIe will ONLY stop at
  1569.  
  1570.     breakpoint addresses where an instruction begins (i.e., where the
  1571.  
  1572.     65C02 processor performs an opcode fetch).  The debugger will NOT stop
  1573.  
  1574.     the 65C02 processor if the breakpoint address falls in the middle of
  1575.  
  1576.     an instruction.  The breakpoint address you specify will remain in
  1577.  
  1578.     effect until you change it.  If you don't want SimSystem IIe to stop
  1579.  
  1580.     at any address you may enter FFFF, since this address is part of the
  1581.  
  1582.     IRQ interrupt vector, and the 65C02 processor should NEVER execute an
  1583.  
  1584.     opcode fetch at this address.
  1585.  
  1586.  
  1587.  
  1588.     After entering the breakpoint address SimSystem IIe will behave as it
  1589.  
  1590.     otherwise would, although somewhat more slowly.  Function keys F1
  1591.  
  1592.     through F4 perform special debugger tasks, as described in chapter 9.
  1593.  
  1594.  
  1595.  
  1596.     Function key F1 will toggle the debugger display on and off. 
  1597.  
  1598.     SimSystem IIe slows down even more with the debugger display on, since
  1599.  
  1600.     each instruction is displayed as it is executed.
  1601.  
  1602.  
  1603.                                     Page 20
  1604.  
  1605.  
  1606.  
  1607.  
  1608.     Function key F2 will toggle between STEP and RUN mode.  You can
  1609.  
  1610.     restart the 65C02 processor after a debugger breakpoint by pressing
  1611.  
  1612.     the F2 key.
  1613.  
  1614.  
  1615.  
  1616.     Function key F3 will display the Set Breakpoint box (just as it was
  1617.  
  1618.     displayed at the start of the program) so that you may enter a
  1619.  
  1620.     different breakpoint.  You can step past a subroutine call by setting
  1621.  
  1622.     the breakpoint to the address of the first instruction after the JSR
  1623.  
  1624.     and pressing F2 to restart the 65C02.  SimSystem IIe will return to
  1625.  
  1626.     STEP mode after the subroutine returns.
  1627.  
  1628.  
  1629.  
  1630.     Function key F4 is used to step the 65C02 processor a single
  1631.  
  1632.     instruction.
  1633.  
  1634.  
  1635.  
  1636.     The debugger display looks like this:
  1637.  
  1638.  
  1639.  
  1640.          PC=1234 SP=0180 A=00 X=FF Y=10 PS=NVBDIZC LDA ($30),Y $8010
  1641.  
  1642.  
  1643.  
  1644.     The field 'PC=1234' tells us that the current instruction (program
  1645.  
  1646.     counter) is at address $1234.  The field 'SP=0180' indicates the
  1647.  
  1648.     current address of the stack pointer.  The fields 'A=00', 'X=FF', and
  1649.  
  1650.     'Y=10' show the current contents of the three processor data
  1651.  
  1652.     registers.  The field 'PS=NVBDIZC' show the processor status bits
  1653.  
  1654.     Negative, oVerflow, Break, Decimal, Interrupt disable, Zero, and
  1655.  
  1656.     Carry.  The letter representing each bit is only displayed when the
  1657.  
  1658.     corresponding bit is ON, otherwise they are displayed as a period. 
  1659.  
  1660.     The instruction at the current address is displayed (in this case, LDA
  1661.  
  1662.     ($30),Y).  Since indirect addressing is used, the effective address is
  1663.  
  1664.     also displayed ($8010).  Since the Y register contains $10, we can
  1665.  
  1666.     deduce that the indirect address at zero page location $30 and $31 is
  1667.  
  1668.     $8000.
  1669.  
  1670.  
  1671.  
  1672.     All of the other SimSystem IIe function keys will work normally even
  1673.  
  1674.     when the 65C02 processor is halted by the debugger.
  1675.  
  1676.  
  1677.  
  1678.                                     Page 21
  1679.  
  1680.  
  1681.                        Chapter 11 - Volume File Formats
  1682.  
  1683.                        ________________________________
  1684.  
  1685.  
  1686.  
  1687.     It is our hope that everyone who tries SimSystem IIe will find it
  1688.  
  1689.     useful, and will choose to pay the reasonable $50 registration fee. 
  1690.  
  1691.     As an incentive, we offer the SimDisk program to registered users. 
  1692.  
  1693.     With SimDisk you can create volume files for SimSystem IIe, copy files
  1694.  
  1695.     from MS-DOS to SimSystem IIe volumes (or vice versa), and generate
  1696.  
  1697.     volumes from real Apple diskettes using the Deluxe Option Board, from
  1698.  
  1699.     Central Point software.  We also offer an in-depth users manual,
  1700.  
  1701.     complete with figures and technical references, printed and
  1702.  
  1703.     professionally bound.
  1704.  
  1705.  
  1706.  
  1707.     In the real world, however, we realize that many people will not pay
  1708.  
  1709.     the registration fee regardless of any incentives we provide.  While
  1710.  
  1711.     we don't want to remove the incentive to register, we also don't want
  1712.  
  1713.     to make it impossible to use SimSystem IIe with anything but the few
  1714.  
  1715.     demo programs we provide with it.  In fact, some people may choose NOT
  1716.  
  1717.     to register until they can verify whether SimSystem IIe is compatible
  1718.  
  1719.     with specific Apple II software.  For this reason we are providing a
  1720.  
  1721.     description of the volume files used by SimSystem IIe.  Any moderately
  1722.  
  1723.     skilled programmer will be able to create a program that can generate
  1724.  
  1725.     the volume files.  Who knows - maybe we'll offer to include such a
  1726.  
  1727.     program with future shareware versions of SimSystem IIe, and share the
  1728.  
  1729.     registration fee with the programs author...  (It would have to be
  1730.  
  1731.     REALLY good, though...)
  1732.  
  1733.  
  1734.  
  1735.     Floppy (*.IIE) Volumes
  1736.  
  1737.  
  1738.  
  1739.          Floppy volume files come in two basic flavors; binary and GCR. 
  1740.  
  1741.          Both types have the DOS extension *.IIE, and both types begin
  1742.  
  1743.          with a header, as follows:
  1744.  
  1745.  
  1746.  
  1747.               13 bytes - ASCII text "SIMSYSTEM_IIE"
  1748.  
  1749.               1 byte - volume type, as follows:
  1750.  
  1751.                    00 - binary ProDOS volume
  1752.  
  1753.                    01 - binary Apple DOS volume
  1754.  
  1755.                    02 - binary unknown operating system
  1756.  
  1757.                    03 - GCR unknown operating system
  1758.  
  1759.  
  1760.  
  1761.          All of the binary formats, 0 through 2, are treated the same by
  1762.  
  1763.          SimSystem IIe.  The reference to which operating system format
  1764.  
  1765.          they use is for informational purposes only.  Utility programs
  1766.  
  1767.          should NOT count on this value to determine the directory format
  1768.  
  1769.          for the volume data.
  1770.  
  1771.  
  1772.  
  1773.          All of the binary format volume files continue, as follows:
  1774.  
  1775.  
  1776.  
  1777.               16 bytes - sector interleave table
  1778.  
  1779.                    This table indicates the physical order of the sectors
  1780.  
  1781.                    in each track image.  SimSystem IIe uses this
  1782.  
  1783.                    information to create sector address fields when
  1784.  
  1785.                    generating GCR data from the volume file data.
  1786.  
  1787.               4096 bytes - track 0 data
  1788.  
  1789.               4096 bytes - track 1 data
  1790.  
  1791.  
  1792.                                          Page 22
  1793.  
  1794.  
  1795.               ...
  1796.  
  1797.               4096 bytes - track 34 data
  1798.  
  1799.  
  1800.  
  1801.          All of the GCR format volume files continue, as follows:
  1802.  
  1803.  
  1804.  
  1805.               37 words - track size table
  1806.  
  1807.                    GCR volumes contain data for 37 tracks (as opposed to
  1808.  
  1809.                    the normal 35 tracks on an Apple disk).  This is in
  1810.  
  1811.                    support of the those Apple copy protection schemes that
  1812.  
  1813.                    use extra tracks at the inside diameter of the disk. 
  1814.  
  1815.                    Each word in this table (in Intel low byte/high byte
  1816.  
  1817.                    order) indicates the size of each GCR track image in
  1818.  
  1819.                    bytes.
  1820.  
  1821.               ???? bytes - track 0 GCR data
  1822.  
  1823.               ???? bytes - track 1 GCR data
  1824.  
  1825.               ...
  1826.  
  1827.               ???? bytes - track 36 GCR data
  1828.  
  1829.  
  1830.  
  1831.     Hard Disk (*.HDV) Volumes
  1832.  
  1833.  
  1834.  
  1835.          SimSystem IIe hard disk volumes always contain binary data.  In
  1836.  
  1837.          addition, they are only compatible with Apple ProDOS operating
  1838.  
  1839.          systems.  For this reason, the data are stored in ProDOS blocks
  1840.  
  1841.          (512 bytes each).
  1842.  
  1843.  
  1844.  
  1845.          The format of a SimSystem IIe hard disk volume file is as
  1846.  
  1847.          follows:
  1848.  
  1849.  
  1850.  
  1851.               13 bytes - ASCII text "SIMSYSTEM_HDV"
  1852.  
  1853.               1 word - size of the volume (low byte/high byte) in ProDOS
  1854.  
  1855.               blocks
  1856.  
  1857.               512 bytes - block 0 data
  1858.  
  1859.               512 bytes - block 1 data
  1860.  
  1861.               ...
  1862.  
  1863.               512 bytes - last block data
  1864.  
  1865.  
  1866.  
  1867.          Given the appropriate boot sector data, these volume files can be
  1868.  
  1869.          used to boot SimSystem IIe.  Curiously enough, the Apple boot
  1870.  
  1871.          sector for a ProDOS volume is identical for a hard drive and a
  1872.  
  1873.          floppy disk.  SimSystem IIe hard drive ROM code (slot 7) conforms
  1874.  
  1875.          to the Apple standard for a hard disk, and will boot ProDOS from
  1876.  
  1877.          a standard Apple volume.
  1878.  
  1879.  
  1880.  
  1881.          Good Luck!!!
  1882.  
  1883.  
  1884.  
  1885.                                       Page 23
  1886.  
  1887.  
  1888.                               Appendix - Registration
  1889.  
  1890.                               _______________________
  1891.  
  1892.  
  1893.  
  1894.     Hopefully, all of this has given you sufficient enticement to break
  1895.  
  1896.     out your check book and send in your registration.  The registration
  1897.  
  1898.     fee is $50 U.S., plus $6 to cover shipping costs.  Make out your check
  1899.  
  1900.     to:
  1901.  
  1902.  
  1903.  
  1904.          American Research Inc.
  1905.  
  1906.          2120 Deercreek Rd.
  1907.  
  1908.          Simi Valley, CA 93065
  1909.  
  1910.  
  1911.  
  1912.     California residents should add the appropriate sales tax.  Your
  1913.  
  1914.     registered copy of SimSystem IIe will be sent out as soon as your
  1915.  
  1916.     check has cleared.  You can save some time by sending a money order or
  1917.  
  1918.     cashiers check, which will get you same day service.
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.